home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
MacUser Mac Bin 40
/
MACUSER-MACBIN40A-1997-03.ISO.7z
/
MACUSER-MACBIN40A-1997-03.ISO
/
オンラインソフト
/
オンラインソフト⁄毎号掲載
/
音楽,音声処理
/
MIDIGraphy folder
/
MGPC folder
/
Documents
/
Japanese
/
notes⁄manual
Wrap
Text File
|
1996-11-22
|
21KB
|
533 lines
□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□
□ □
□ MG Profile Compiler Ver.1.3.0 / Release Notes (Japanese edition) □
□ Copyright (c) 1993-96 TONTATA □
□ ------------------------------------------------------------------ □
□ Created by TONTATA (自来也愛好会) □
□ NIFTY-Serve : NCA02217 □
□ Internet : NCA02217@niftyserve.or.jp □
□ mmaeda@ca2.so-net.or.jp □
□ tontata@kagi.com □
□ Home Page : http://ux01.so-net.or.jp/~mmaeda/ □
□ □
□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□
----------------------------------------------------------------------------
【使用上の注意事項】
・使用方法等についてのマニュアルは本ファイル後半部分に記述してあります。
使用前に良くお読み下さい。
・本ソフトで作成したデータの再配布には条件が定められています。詳しくは下記の
配布/転載条件を御参照下さい。
----------------------------------------------------------------------------
【動作環境】
・漢字Talk 7.0以降で動作します。それ以前のバージョンでの動作確認は行っていま
せん。
----------------------------------------------------------------------------
【使用条件】
・本ソフトウエアは、別配布のMIDIGraphy本体パッケージ(以下MIDIGraphy本体)の
一部を構成するものとします。ただし、使用条件等一部MIDIGraphy本体と異なる部
分がありますのでご注意ください。
・MIDIGraphyパッケージはシェアウエアです。本ソフトウエアとMIDIGraphy本体とを
総合してその価値ありと認められる方は、MIDIGraphy本体シェアウエアフィーをお
支払いください。支払方法についてはMIDIGraphy本体に添付のrelease notesをご
覧ください。
・MIDIGraphy本体で既にお支払いいただいている方は、必ずしもお支払いいただく必
要はありません。
----------------------------------------------------------------------------
【配布/転載条件】
・本パッケージの無償メディアによる配布/転載は以下の条件を満たす限りにおいて
自由です。
- ドキュメントを含め、パッケージ内容に変更を加えないこと.
- 転載後で結構ですので転載先等をメールにて作者まで御連絡下さい.
・有償メディアによるソフトウエアの配布に際しては必ず事前に御連絡ください。
有償メディアによる配布については、原則として以下の条件をつけさせていただい
ています。
a.配布価格等が不当なものでないこと.
b.配布に伴い、一切の権利・義務に関しての移動が発生しないこと.
c.作者本人より配布されているものからいかなる改変も加えないこと(但し、圧
縮ファイルを解凍したファイルセットでの配布に関しては改変とは見なさない
ものとします).
d.配布するメディアを作者保管用として1セット提供していただくこと.
・本ソフトを営利目的に使用する場合は、必ず事前に作者の承諾を得てください。
・本ソフトウエアにより作成したデータを営利目的に使用する場合には、必ず事前に
作者の承諾を得てください。
・本ソフトウエアに添付のサンプルファイルを無変更のまま使用して作成したデータ
を個別再配布することは禁止します。
・本ソフトウエア添付のサンプルファイルを改変して作成したデータを配布する場合
には、必ず著作権表記を変更してください。「Copyright (c) TONTATA」の表記のあ
るままで配布することは禁止します。
----------------------------------------------------------------------------
【著作権】
・本ソフトウエアおよび添付ドキュメント、サンプルファイル等の著作権は作者が保
有します。
----------------------------------------------------------------------------
【免責】
・本ソフトウエアまたは添付ドキュメントの使用、または使用不能により生ずるいか
なる損害についても、作者はその責任を負いません。
・本ソフトウエアにより作成したデータを第三者に配布することは、前記配布/転載
条件を守る限り自由です。但し、配布および配布物により生ずるいかなる事象につ
いても、作者はその責任を負いません。
・MIDIGraphy本体と各種モジュールファイル/プロファイル等とのインタフェースは
予告なく変更されることがあります。あらかじめご了承下さい。
----------------------------------------------------------------------------
【バージョンアップ変更履歴】
Ver.1.3.0 (1996/11/22)
・作成されるプロファイルのクリエータをMIDIGraphy 1.3.0に合わせ変更
・SC-88 Profileソースを追加
・QY10 Profileソースを追加
・QTMI ProfileをQuickTime 2.5対応に変更
・英文ドキュメントおよびプロファイル文字列中のスペルミスを修正
・いくつかのprofileリソースのデータ間違いを修正
Ver.1.2.1 (1996/04/12)
・QTMI Profileのソースを追加
・英文ドキュメントを追加
Ver.1.2.0 (1996/03/20)
・SystemExclusiveフィルタをコードリソースからデータリソースに変更(新規作成機能追加)
・profile source中のスペルミスを修正
Ver.1.1.1 (1996/02/12)
・サンプルソースのスペルミスを修正
・AppleEvent対応(必須AppleEventのみ)
Ver.1.0.5 (1995/11/18)
・versリソースを記述できるよう機能追加
・シンボル定義文機能追加
・マニュアル作成
・その他細かいバグ修正
Ver.0.9.0(β版) (1995/11/04)
----------------------------------------------------------------------------
□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□
□ □
□ MG Profile Compiler Ver.1.3.0 / User's Manual (Japanese edition) □
□ Copyright (c) 1993-96 TONTATA □
□ ------------------------------------------------------------------ □
□ Created by TONTATA (自来也愛好会) □
□ NIFTY-Serve : NCA02217 □
□ Internet : NCA02217@niftyserve.or.jp □
□ mmaeda@ca2.so-net.or.jp □
□ tontata@kagi.com □
□ Home Page : http://ux01.so-net.or.jp/~mmaeda/ □
□ □
□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□
目次
 ̄ ̄
1. 概要
2. 使用方法
2.1. ファイル構成
2.2. コンパイル方法
2.3. エラーメッセージ
A. MGPC文法
A1. 制御文
A1.1. コメント
A1.2. ファイル取り込み
A1.3. シンボル定義
A2. 記述方式
A2.1. 文字列記述
A2.2. 数値記述
A2.3. ファイルパス記述
A3. 定義文
A3.1. プロファイル定義
A3.2. リソース定義
A3.2.1. 'vers'リソース定義
A3.2.2. 'PNam'リソース定義
A3.2.3. 'NNam'リソース定義
A3.2.4. 'Midi'リソース定義
A3.2.5. 'Mid#'リソース定義
A3.2.6. 'Exdf'リソース定義
----------------------------------------------------------------------------
1. 概要
 ̄ ̄ ̄ ̄ ̄ ̄
MG Profile Compilerは、MIDIGraphyで使用するProfileを作成するためのツールで
す。テキストファイルとして作成したソースファイルをコンパイルしてProfileを作
成します。MGProfCompilerでは、以下のリソースを記述できます。
・'vers':バージョン/著作権表記リソース
・'PNam':プログラム名リストリソース
・'NNam':ノート名リストリソース
・'Midi':ダイレクト送出MIDIデータリソース
・'Mid#':ダイレクト送出MIDIデータリストリソース
・'Exdf':システムエクスクルーシブフィルタリソース
2. 使用方法
 ̄ ̄ ̄ ̄ ̄ ̄
2.1. ファイル構成
本パッケージには以下のファイルが含まれています。
MGPC folder :MG Profile Compilerパッケージフォルダ
├ MGProfCompiler :MG Profile Compiler
├ mgpc.doc :本ファイル
└ profile sources :サンプルソースファイル収納フォルダ
├ makeall.s :全ファイル作成ソースファイル
├ ExflRsrc :各種Exfl収納ファイル
└ ***.s :各音源Profile用ソースファイル
MG Profile Compilerおよびソースファイルはどこにおいても構いません。
2.2. コンパイル方法
MG Profile Compilerはコンパイルのみ行ないます。ソースファイルの編集には別
途テキストエディタを使用して下さい。TEXTファイルが扱えるエディタならOKです
が、中には32KB以上の大きなファイルを編集できないものもありますのでご注意くだ
さい。サンプルファイルでは32KBを超えるものはありませんが、場合によっては
32KB以上を扱えるテキストエディタが必要になるかもしれません。ちなみに作者自身
は山田浩大氏作のASLEdit+を使用しています。
後述の文法に基づいてソースファイルを記述してください。MG Profile Compiler
はごく単純なエラーチェックしか行っていませんので、文法を良く理解した上で記述
を行なってください。
ソースファイルを記述したら、MG Profile Compilerでコンパイルします。コンパ
イルの方法は、以下の2つのうちいずれかを行なってください。オプション設定等は
一切必要ありません。
方法A:
・MG Profile Compilerを起動
・File>Compileを選ぶ
・ファイル選択ダイアログでソースファイルを選択する。
方法B:
・MG Profile CompilerのアイコンにソースファイルをDrag&Dropする。
コンパイル中はProgressダイアログが表示され、エラーが発生した場合はメッセー
ジダイアログを表示した後、コンパイル処理を中止します。
2.3. エラーメッセージ
MG Profile Compilerの出力するエラーメッセージはには以下のものがあります。
・"file cannot open."
インクルードファイルが見つかりません。
・"syntax error."
文法エラーです。
・"comment not closed."
コメントが正しく閉じられていません。
・"include nesting overflow."
インクルードのネストがオーバーフローしました。
・"undefined directive."
未定義の制御文です。
・"String too log."
文字列が長すぎます。
・"Resource not found."
雛型リソースが見つかりません。
・"Memory low."
メモリが足りません。
----------------------------------------------------------------------------
A. MGPC文法
 ̄ ̄ ̄ ̄ ̄ ̄
A1. 制御文
A1.1. コメント
以下の2つの記述はコメントとして扱われ、コンパイル時には無視されます。
/* コメント(複数行可)。 */
または
// 行末までコメント
コメント中にあるの「/*」はコメント開始とはみなされません。
2番目の形式のコメント内にある「*/」はコメント終了とはみなされません。
最初の形式のコメント内にある「//」はコメント開始とはみなされません。
A1.2. ファイル取り込み
以下の2つの記述はいずれもファイル取り込みを指示します。
#include "パス名"
または
#include <パス名>
いずれの場合もカレントディレクトリ(ソースファイルのあるディレクトリ)を
基準に検索します。取り込むファイルがカレントディレクトリ以外にある場合は
カレントディレクトリからの相対パス指定または絶対パス指定を記述してくださ
い。パス指定方法は後述します。
A1.3. シンボル定義
以下の記述はシンボルを定義します。
#include シンボル名 定義内容
以降のソース中で「$シンボル名$」と記述された場合、その部分を定義内容に置
換して解釈されます。未定義シンボル名を「$シンボル名$」と記述した場合は
「$」を含めて無視されます(エラーにはなりません)。
なおシンボルの参照は文字列中では行なえません。
A2. 記述方式
A2.1. 文字列記述
以下の記述は文字列を意味します。
"文字列"
または
"文字列 1" "文字列 2" ...
文字列中の「/*」「*/」「//」はコメント開始/終了とはみなされません。文字
列中で「"」の文字を使用する場合は「¥"」と記述します。「¥」そのものを記述
したい場合には「¥¥」と記述します。
文字列を、空白/タブ/改行以外の区切り文字をはさまずに連続した場合、一つ
の連続した文字列として扱われます。そのうち一部または全部がシンボル定義さ
れたものであっても構いません。
A2.2. 数値記述
以下の記述は数値を表します。
十進数値
または
十六進数値 (「0x」で始める)
A2.3. ファイルパス記述
カレントディレクトリ内のファイルはファイル名を文字列としてそのまま記述し
てください。
相対パス指定の場合は、
":ディレクトリ名:ファイル名"
のように「:」から始め、ディレクトリ名を「:」で区切って記述してください。
「::」を記述することにより一つ上の階層、「:::」で二つうえの階層を指定す
ることができます。
絶対パス指定では、
"ボリューム名:ディレクトリ名:ファイル名"
のように記述してください。
A3. 定義文
A3.1. プロファイル定義
以下の記述はプロファイルを定義します。
FILE("パス名"){
リソース定義
リソース定義
:
:
};
「FILE」識別子に続くパス名指定で出力するProfileファイル名を指定します。
出力先はカレントディレクトリを基準とします。カレントディレクトリ以外の場
所にファイルを作成する場合は、絶対パス指定またはカレントディレクトリから
の相対パス指定を記述します。
一つのソースファイル中に複数のプロファイル定義を行なう事ができます。
プロファイル定義中には複数のリソース定義を記述できます。ただし、一つのプ
ロファイル中に複数のversリソース定義がある場合は最後に記述した一つのみが
有効となります。
リソース定義の一部または全部が取り込みファイル内に記述してあっても構いま
せん。
プロファイル定義外のリソース定義はエラーとなります。
A3.2. リソース定義
A3.2.1. 'vers'リソース定義
以下の記述は'vers'リソースを定義します。
vers("リソース名"){
バージョン番号 ,
リビジョン番号上位 ,
リビジョン番号下位 ,
ステージ ,
ビルド番号 ,
国番号 ,
"文字列1" ,
"文字列2" ,
};
「vers」識別子に続くリソース名記述でversリソースの名称を指定します。
本定義では、ファイルバージョンを示す、versリソースID=1が記述できます。
パッケージバージョンを示すversリソースID=2には、MGProfCompilerのパッケー
ジバージョンリソースが自動的にコピーされます。
一つのプロファイル中に複数のversリソース定義がある場合は最後に記述した一
つのみが有効となります。プロファイル定義中にversリソース定義がない場合に
は、デフォルトとしてMGProfCompilerのファイルバージョンリソースが追加され
ます。
A3.2.2. 'PNam'リソース定義
以下の記述は'PNam'リソースを定義します。
PNam("リソース名")=("参照ファイル名","参照リソース名"){
プログラム名定義 ,
プログラム名定義 ,
:
:
};
「PNam」識別子に続くリソース名記述でPNamリソースの名称を指定します。参照
ファイル名と参照リソース名は雛型とするPNamリソースのファイル名とリソース
名を指定します。
雛型を使用しない場合は「=("参照ファイル名","参照リソース名")」を省略でき
ます。また、「"参照ファイル名"」を省略した場合には、現在作成中のプロファ
イル中に記述済みのPNamリソースを雛型とします。
雛型をそのまま使用する場合には「{」から「}」までのプログラム名定義群を省
略できます。
以下の記述はプログラム名を定義します。
"プログラム番号:プログラム名"
または
+"プログラム番号:プログラム名"
または
-"プログラム番号:"
または
"-"
プログラム番号は16進2桁の数値を指定します。使用できる文字は「0」-
「9」、「A」-「F」の16種です。「A」-「F」は大文字を指定します。
最初の形式は、雛型および既に定義済みのプログラム名定義を検索し、同一プロ
グラム番号の記述があればそれを記述したプログラム名に置き換えます。
二番目の形式は、すでに雛型および既に定義済みのプログラム名定義に同一プロ
グラム番号が存在する場合でも無条件に記述したプログラム名定義を最後に追加
します。
三番目の形式は、雛型および既に定義済みのプログラム名定義を検索し、指定し
たプログラム番号のプログラム名定義を削除します。
最後の形式はセパレータです。ポップアップメニュー表示の際にメニューセパ
レータとして扱われます。
A3.2.3. 'NNam'リソース定義
以下の記述は'NNam'リソースを定義します。
NNam("リソース名")=("参照ファイル名","参照リソース名"){
ノート名定義 ,
ノート名定義 ,
:
:
};
「NNam」識別子に続くリソース名記述でNNamリソースの名称を指定します。参照
ファイル名と参照リソース名は雛型とするNNamリソースのファイル名とリソース
名を指定します。
雛型を使用しない場合は「=("参照ファイル名","参照リソース名")」を省略でき
ます。また、「"参照ファイル名"」を省略した場合には、現在作成中のプロファ
イル中に記述済みのNNamリソースを雛型とします。
雛型をそのまま使用する場合には「{」から「}」までのノート名定義群を省略で
きます。
以下の記述はノート名を定義します。
"ノート番号:ノート名"
または
+"ノート番号:ノート名"
または
-"ノート番号:"
または
"-"
ノート番号は16進2桁の数値を指定します。使用できる文字は「0」-「9」、
「A」-「F」の16種です。「A」-「F」は大文字を指定します。
最初の形式は、雛型および既に定義済みのノート名定義を検索し、同一ノート番
号の記述があればそれを記述したノート名に置き換えます。
二番目の形式は、すでに雛型および既に定義済みのノート名定義に同一ノート番
号が存在する場合でも無条件に記述したノート名定義を最後に追加します。
三番目の形式は、雛型および既に定義済みのノート名定義を検索し、指定した
ノート番号のノート名定義を削除します。
最後の形式はセパレータです。ポップアップメニュー表示の際にメニューセパ
レータとして扱われます。
A3.2.4. 'Midi'リソース定義
以下の記述は'Midi'リソースを定義します。
Midi("リソース名")=("参照ファイル名","参照リソース名");
または
Midi("リソース名"){
MIDIイベント定義
};
「Midi」識別子に続くリソース名記述でMidiリソースの名称を指定します。
最初の形式は、他のMidiリソースをそのままコピーします。参照ファイル名と参
照リソース名は雛型とするMid#リソースのファイル名とリソース名を指定します。
二番目の形式はMIDIイベント定義で記述された内容のMidiリソースを作成しま
す。MIDIイベント定義は16進文字列で定義します。
A3.2.5. 'Mid#'リソース定義
以下の記述は'Mid#'リソースを定義します。
Mid#("リソース名")=("参照ファイル名","参照リソース名"){
Midiリソース名 ,
Midiリソース名 ,
:
:
};
「Mid#」識別子に続くリソース名記述でMid#リソースの名称を指定します。参照
ファイル名と参照リソース名は雛型とするMid#リソースのファイル名とリソース
名を指定します。
雛型を使用しない場合は「=("参照ファイル名","参照リソース名")」を省略でき
ます。また、「"参照ファイル名"」を省略した場合には、現在作成中のプロファ
イル中に記述済みのMid#リソースを雛型とします。
雛型をそのまま使用する場合には「{」から「}」までのMidiリソース名定義群を
省略できます。
Midiリソース名は記述されたものがそのまま追加され、内容の妥当性はコンパイ
ル時にはチェックされません(MIDIGrapphyでの実行時にチェックされます)。
A3.2.6. 'Exdf'リソース定義
以下の記述は'Exdf'リソースを定義します。
Exdf("リソース名")=("参照ファイル名","参照リソース名");
または
Exdf("リソース名"){
フィールド定義 ,
フィールド定義 ,
:
};
「Exdf」識別子に続くリソース名記述でExdfリソースの名称を指定します。
最初の形式は、他のExdfリソースをそのままコピーします。参照ファイル名と参
照リソース名は雛型とするExdfリソースのファイル名とリソース名を指定します。
二番目の形式はフィールド定義で記述された内容のExdfリソースを作成します。
フィールド定義は以下のように記述します。
フィールド名,タイプ,ビット数,データ
フィールド名には文字列を記述します。可変データおよび可変長データの場合に
は、MIDIGraphyのシステムエクスクルーシブ編集ダイアログにおいて、項目名と
して表示されます。
タイプには以下のうちいずれかを指定します。
$Exdf_fix$ :固定値フィールドを指定します。ビット数はフィー
ルドのサイズを記述します。また、データには固定
値データを記述します。システムエクスクルーシブ
認識時にはフィールドが指定したデータと一致する
かどうかがチェックされます。
$Exdf_val$ :可変データです。ビット数にはフィールドのサイズ
を記述します。データにはデフォルト値を記述しま
す。
$Exdf_data$ :可変長データです。ビット数は可変長の単位となる
ビット数を記述します。また、データにはデフォル
ト値を記述します。
$Exdf_sumStart$ :チェックサム計算の開始点を指定します。ビット数、
データの指定は使用されません。
$Exdf_sumEnd$ :チェックサム計算の開始点を指定します。ビット数、
データの指定は使用されません。
$Exdf_sum$ :チェックサム計算結果を格納するフィールドを指定
します。チェックサムは開始点から終了点までを加
算し、チェックサムフィールドを加えた数値の下位
7ビットが0となるような数値が格納されます。
$Exdf_end$ :Exdfリソースの終了を指定します。Exdfリソースの
最終フィールドは必ずこのフィールドで終わらなけ
ればなりません。
上記のタイプ定義に用いられる定数はMGProfileCompiler内であらかじめ定義さ
れています。
----------------------------------------------------------------------------